home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 March / EnigmA AMIGA RUN 05 (1996)(G.R. Edizioni)(IT)[!][issue 1996-03][Skylink CD IV].iso / earcd / gnu / gnupltdc.lha / docs / README < prev    next >
Text File  |  1996-01-22  |  4KB  |  113 lines
  1. Notes on the gnuplot help files and documentation.
  2.  
  3. Gnuplot documentation is available in three ways:
  4.  
  5. 1 - interactively, within gnuplot
  6. 2 - as a printed document. 
  7. 3 - as a manual page, through the Unix man(1) facility
  8.  
  9. The first two forms describe the inner workings, and contain
  10. equivalent information, while the third form tells how to run gnuplot.
  11.  
  12. The two first forms above derive their information from the file
  13. gnuplot.doc, which is the MASTER copy of gnuplot help information. All
  14. other forms, except for gnuplot.1, the man page, are derived from it. 
  15.  
  16. gnuplot.doc -> gnuplot.hlp 
  17.             -> gnuplot.gih
  18.             -> gnuplot.tex
  19.             -> gnuplot.ms
  20.             -> gnuplot.rtf
  21.                                       
  22. On VMS the interactive help is supplied by the system help facility,
  23. using the gnuplot.hlp file. This is made with ('make hlp') and must
  24. be put into a library, either a specific gnuplot.hlb or any of the
  25. system-wide help libraries, using lib/help ('help lib'). On Unix,
  26. AmigaDOS, and MSDOS the interactive help is built in to the program,
  27. and uses the gnuplot.gih file ('make gih').  On MS-Windows, the
  28. Microsoft help compiler converts an 'rtf' file to an 'hlp' file 
  29. which is used by the standard Windows help program.
  30.  
  31. The printed document is available in either latex or troff/nroff (ms)
  32. format, using gnuplot.tex or gnuplot.ms, derived from gnuplot.doc with
  33. either doc2tex or doc2ms. Type 'make dvi' or 'make nroff'. For troff,
  34. type 'make ms' and then troff -ms gnuplot.ms in whatever way you use
  35. troff.
  36.  
  37. If VMS users prefer the gnuplot interactive help facility to the
  38. system facility, this can be easily changed in command.c.
  39.  
  40.  
  41. Description of the gnuplot.doc format:
  42. --------------------------------------
  43.  
  44. Here is an example of the DOC master help format:
  45.  
  46. ?
  47. 1 gnuplot
  48.  GNUPLOT is a command-driven interactive function plotting program.  It
  49.  ...
  50. ?exit
  51. 2 exit
  52.  'exit', 'quit' and ...
  53. ?expressions
  54. 2 expressions
  55.  In general, any mathematical expression accepted by C, ...
  56.  
  57.  Topics:
  58.  functions operators
  59. ?expressions functions
  60. ?functions
  61. 3 functions
  62.  The functions in GNUPLOT are ...
  63.  
  64.  Topics:
  65.  abs acos arg ...
  66. ?expressions functions abs
  67. ?functions abs
  68. ?abs
  69. 4 abs
  70.  This function returns the absolute value of its argument.  The
  71.  returned value is of the same type as the argument. 
  72. ?expressions functions acos
  73. ?functions acos
  74. ?acos
  75. 4 acos
  76.  This function returns the arc cosine (inverse cosine) of its
  77.  argument.  'acos' returns its argument in radians. 
  78.  
  79.  
  80. Some notes about the format:
  81. ----------------------------
  82. Remember that all text must be able to be processed by gnuplot, VMS,
  83.  nroff, troff, and latex, and always do something reasonable. 
  84. The first column is reserved for control characters.
  85. Text does not start in the first column.
  86. Lines that start in column 2 may be typeset by LaTeX.
  87. Lines that have a space in column 2 are to be printed in a verbatim
  88.  environment by LaTeX.
  89. Tables must have a space in column 2.
  90. Do NOT use tabs in the help file.
  91. Conversion from this format to vax .hlp file involves removal of
  92.  lines starting with [?@#$%] (see doc2hlp). VMS uses the numbers
  93.  to represent a tree. 
  94. Conversion from this format to gnuplot .gih file involves removal of
  95.  lines starting with [0-9@#$%] (see doc2gih). Gnuplot matches your
  96.  help query against the ? lines to find the help information.
  97.  Multiple ? lines for one text block constitute synonyms. The most
  98.  specific should be first, eg 'expressions functions' before 'functions'.
  99.  Spaces are allowed here, but should be single.
  100. Backquote pairs are converted by the doc2tex program into boldface;
  101.  that is, `some text` is converted to {\bf some text}. Be sure to pair
  102.  the backquotes, or the whole document will be boldface!
  103.  
  104. Control characters in first column:
  105. ?    used by .gih format, for builtin interactive help - keyword
  106. 0-9  used by VMS help and by doc2{tex,ms} formatters to define level,keyword
  107. @    used by doc2{tex,ms} to define table start/end
  108. #    used by doc2tex: table entry
  109. %    used by doc2ms: table entry
  110.  
  111. ^    used by doc2html : hypertext link
  112. <    the help from the terminal driver files is inserted at this point.
  113.